<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
  <meta http-equiv="content-type"
 content="text/html; charset=ISO-8859-1">
  <title>Role</title>
</head>
<body>
<h1>Role</h1>
Roles are functions which users take on in the context of Velocityme.
In practice they correspond to different combinations of permissions
but it is helpful to identify roles that make sense in your particular
organisation. Roles are one of three elements which come together when
assigning permission. The other two elements are Users or Groups and Nodes
(described in User and Group Accesses).<br>
<br>
All roles are stored in /Root/System Configuration/Setup Roles. A
default role is automatically created with the system install. Initial
configuration of the system is performed using this role but it is
recommended that appropriate roles be identified for your environment
and be created and assigned as soon as possible. Examples of roles are:
Administrator, Developer, Tester, Project Manager etc.<br>
<br>
A role entity contains the following bits of information: a name and
description, a check box indicating whether or not the role is
recursive, and a set of permissions. A non-recursive role will only
give the user the specified permissions in one node. A recursive role
will give the user the specified permissions in a whole branch of the
tree rooted in the node where the user or group access is setup.<br>
<br>
A role can enable and disable each of the permissions independently.<br>
<h2>Creating Roles</h2>
Navigate the tree to /Root/System Configuration/Setup Roles. If
you have permission to create roles then the "Create New Role" button
on the toolbar will be enabled. Pressing it will
bring up a new panel for creating a role. Enter the
appropriate information and press OK to create the role or
Cancel to discard it with no action taken. If the role is
created, it will be initialised with a change log recording the initial
details.<br>
<h2>Editing Roles</h2>
If you have permission to edit the role then the Edit button
will be enabled. Pressing it makes each of the available parts
editable. The recursive check box as well as the table of permission
check boxes can be selected or deselected using the mouse. Once the
changes have been made, pressing OK will commit them to the system with
an appropriate change log. Pressing Cancel will close the panel without
making any change to the system.<br>
<br>
<br>
</body>
</html>
